home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 2000 November: Tool Chest / Dev.CD Nov 00 TC Disk 2.toast / pc / sample code / quicktime / basics / qtcreatemovie / qtsound.c < prev    next >
Encoding:
C/C++ Source or Header  |  2000-09-28  |  12.6 KB  |  462 lines
  1. /*
  2.     File:        QTSound.c
  3.     
  4.     Contains:    Sound code for QuickTime CreateMovie sample
  5.     
  6.     Written by:    Scott Kuechle
  7.                 (based heavily on QuickTime sample code in Inside Macintosh: QuickTime)
  8.  
  9.     Copyright:    © 1998 by Apple Computer, Inc. All rights reserved
  10.     
  11.     Change History (most recent first)
  12.     
  13.         <2>        9/28/98        rtm        changes for Metrowerks compiler
  14.         <1>        6/26/98        srk        first file
  15.  
  16.  
  17. */
  18.  
  19. /************************************************************
  20. *                                                           *
  21. *    INCLUDE FILES                                          *
  22. *                                                           *
  23. *************************************************************/
  24.  
  25.  
  26. #if !defined(_MSC_VER) && _WIN32
  27.     #include <Win32Headers.mch>
  28.     #define TARGET_OS_WIN32            1
  29. #else
  30.     #include <ConditionalMacros.h>
  31. #endif
  32.  
  33. #if TARGET_OS_WIN32
  34.     #include <QTML.h>
  35.     #define    STRICT
  36.     #include <windows.h>
  37. #endif
  38.  
  39. #include <Resources.h>
  40. #include <FixMath.h>
  41. #include <Sound.h>
  42.  
  43. #include "CreateMovie.h"
  44. #include "QTSound.h"
  45.  
  46. /************************************************************
  47. *                                                           *
  48. *    TYPE DEFINITIONS                                       *
  49. *                                                           *
  50. *************************************************************/
  51.  
  52. typedef SndCommand *SndCmdPtr;
  53.  
  54. #if PRAGMA_STRUCT_ALIGN
  55.     #pragma options align=mac68k
  56. #elif PRAGMA_STRUCT_PACKPUSH
  57.     #pragma pack(push, 2)
  58. #elif PRAGMA_STRUCT_PACK
  59.     #pragma pack(2)
  60. #endif
  61.  
  62.     /* 'snd ' resource format 1 - see the Sound Manager chapter of Inside Macintosh: Sound
  63.         for the details */
  64.     typedef struct 
  65.     {
  66.         short format;
  67.         short numSynths;
  68.     } Snd1Header, *Snd1HdrPtr, **Snd1HdrHndl;
  69.  
  70.     /* 'snd ' resource format 2 - see the Sound Manager chapter of Inside Macintosh: Sound
  71.         for the details */
  72.  
  73.     typedef struct 
  74.     {
  75.         short format;
  76.         short refCount;
  77.     } Snd2Header, *Snd2HdrPtr, **Snd2HdrHndl;
  78.  
  79.  
  80. #if PRAGMA_STRUCT_ALIGN
  81.     #pragma options align=reset
  82. #elif PRAGMA_STRUCT_PACKPUSH
  83.     #pragma pack(pop)
  84. #elif PRAGMA_STRUCT_PACK
  85.     #pragma pack()
  86. #endif
  87.  
  88. /************************************************************
  89. *                                                           *
  90. *    FUNCTION PROTOTYPES                                    *
  91. *                                                           *
  92. *************************************************************/
  93.  
  94. static void QTSound_CreateSoundDescription (Handle sndHandle,
  95.                                             SoundDescriptionHandle sndDesc,
  96.                                             long *sndDataOffset,
  97.                                             long *numSamples,
  98.                                             long *sndDataSize );
  99. static long QTSound_GetSndHdrOffset (Handle sndHandle);
  100.  
  101. /************************************************************
  102. *                                                           *
  103. *    CONSTANTS                                              *
  104. *                                                           *
  105. *************************************************************/
  106.  
  107. #define    kOurSoundResourceID 128
  108.  
  109. #define    kSoundSampleDuration 1
  110. #define    kSyncSample 0
  111. #define    kTrackStart    0
  112. #define    kMediaStart    0
  113. /* 
  114. for the following constants, please consult the Macintosh
  115. Audio Compression and Expansion Toolkit
  116. */
  117. #define kMACEBeginningNumberOfBytes 6
  118. #define kMACE31MonoPacketSize 2
  119. #define kMACE31StereoPacketSize 4
  120. #define kMACE61MonoPacketSize 1
  121. #define kMACE61StereoPacketSize 2
  122.  
  123.  
  124. /************************************************************
  125. *                                                           *
  126. *    QTSound_CreateMySoundTrack()                           *
  127. *                                                           *
  128. *    Creates a QuickTime movie sound track & media data     *
  129. *                                                           *
  130. *************************************************************/
  131.  
  132.  
  133. void QTSound_CreateMySoundTrack (Movie theMovie)
  134. {
  135.     Track theTrack;
  136.     Media theMedia;
  137.     Handle sndHandle = nil;
  138.     SoundDescriptionHandle sndDesc = nil;
  139.     long sndDataOffset;
  140.     long sndDataSize;
  141.     long numSamples;
  142.     OSErr err = noErr;
  143. #if TARGET_OS_WIN32
  144.  
  145.     char path[MAX_PATH+1];
  146.     short resID;
  147.     FSSpec fsspec;
  148.  
  149.  
  150.         fsspec.vRefNum = 0;
  151.         fsspec.parID = 0;
  152.         GetModuleFileName( NULL, path, MAX_PATH+1);
  153.  
  154.         NativePathNameToFSSpec((char *)&path, &fsspec, 0);
  155.  
  156.             /* open our application resource file so we
  157.                 can access the Macintosh 'snd ' resource */ 
  158.         resID = FSpOpenResFile(&fsspec, fsRdPerm);
  159.         CheckError (ResError(), "FSpOpenResFile error" );
  160.  
  161. #endif
  162.  
  163.  
  164.  
  165.         sndHandle = GetResource ('snd ', kOurSoundResourceID);
  166.         CheckError (ResError(), "GetResource error" );
  167.         if (sndHandle == nil)
  168.         {
  169.             return;
  170.         }
  171.  
  172.         sndDesc = (SoundDescriptionHandle) NewHandle(4);
  173.         CheckError (MemError(), "NewHandle error" );
  174.  
  175.         QTSound_CreateSoundDescription (sndHandle, 
  176.                                         sndDesc, 
  177.                                         &sndDataOffset, 
  178.                                         &numSamples, 
  179.                                         &sndDataSize );
  180.  
  181.         theTrack = NewMovieTrack (theMovie, 0, 0, kFullVolume);
  182.         CheckError (GetMoviesError(), "NewMovieTrack error" );
  183.  
  184.         theMedia = NewTrackMedia (theTrack, SoundMediaType,
  185.                                 FixRound ((**sndDesc).sampleRate),
  186.                                 nil, 0);
  187.         CheckError (GetMoviesError(), "NewTrackMedia error" );
  188.  
  189.         err = BeginMediaEdits (theMedia);
  190.         CheckError( err, "BeginMediaEdits error" );
  191.  
  192.         err = AddMediaSample(theMedia,
  193.                             sndHandle,
  194.                             sndDataOffset,/* offset in data */
  195.                             sndDataSize,
  196.                             kSoundSampleDuration,/* duration of each sound sample */
  197.                             (SampleDescriptionHandle) sndDesc,
  198.                             numSamples,
  199.                             kSyncSample,/* self-contained samples */
  200.                             nil);
  201.         CheckError( err, "AddMediaSample error" );
  202.  
  203.         err = EndMediaEdits (theMedia);
  204.         CheckError( err, "EndMediaEdits error" );
  205.  
  206.         err = InsertMediaIntoTrack (theTrack, 
  207.                                     kTrackStart,/* track start time */
  208.                                     kMediaStart,/* media start time */
  209.                                     GetMediaDuration (theMedia),
  210.                                     fixed1);
  211.         CheckError( err, "InsertMediaIntoTrack error" );
  212.  
  213.         if (sndDesc != nil)
  214.         {
  215.             DisposeHandle( (Handle)sndDesc);
  216.         }
  217. } 
  218.  
  219. /************************************************************
  220. *                                                           *
  221. *    QTSound_CreateSoundDescription()                       *
  222. *                                                           *
  223. *    Creates a SoundDescription structure for a given sound *
  224. *    sample                                                 *
  225. *                                                           *
  226. *************************************************************/
  227.  
  228. static void QTSound_CreateSoundDescription (Handle sndHandle,
  229.                                             SoundDescriptionHandle sndDesc,
  230.                                             long *sndDataOffset,
  231.                                             long *numSamples,
  232.                                             long *sndDataSize )
  233. {
  234.     long sndHdrOffset = 0;
  235.     long sampleDataOffset;
  236.     SoundHeaderPtr sndHdrPtr = nil;
  237.     long numFrames;
  238.     long samplesPerFrame;
  239.     long bytesPerFrame;
  240.     SoundDescriptionPtr sndDescPtr;
  241.  
  242.  
  243.         *sndDataOffset = 0;
  244.         *numSamples = 0;
  245.         *sndDataSize = 0;
  246.  
  247.         SetHandleSize( (Handle)sndDesc, sizeof(SoundDescription) );
  248.         CheckError(MemError(),"SetHandleSize error");
  249.         sndHdrOffset = QTSound_GetSndHdrOffset (sndHandle);
  250.         if (sndHdrOffset == 0)
  251.         {
  252.             CheckError(-1, "QTSound_GetSndHdrOffset error");
  253.         }
  254.  
  255.         /* we can use pointers since we don't move memory */
  256.         sndHdrPtr = (SoundHeaderPtr) (*sndHandle + sndHdrOffset);
  257.         sndDescPtr = *sndDesc;
  258.  
  259.         sndDescPtr->descSize = sizeof (SoundDescription);
  260.         /* total size of sound description structure */
  261.         sndDescPtr->resvd1 = 0;
  262.         sndDescPtr->resvd2 = 0;
  263.         sndDescPtr->dataRefIndex = 1;
  264.         sndDescPtr->compressionID = 0;
  265.         sndDescPtr->packetSize = 0;
  266.         sndDescPtr->version = 0;
  267.         sndDescPtr->revlevel = 0;
  268.         sndDescPtr->vendor = 0; 
  269.  
  270.         switch (sndHdrPtr->encode) 
  271.         {
  272.             case stdSH:
  273.                 sndDescPtr->dataFormat = kRawCodecType;
  274.                 /* uncompressed offset-binary data */
  275.                 sndDescPtr->numChannels = 1;
  276.                 /* number of channels of sound */
  277.                 sndDescPtr->sampleSize = 8;
  278.                 /* number of bits per sample */
  279.                 sndDescPtr->sampleRate = sndHdrPtr->sampleRate;
  280.                 /* sample rate */
  281.                 *numSamples = sndHdrPtr->length;
  282.                 *sndDataSize = *numSamples;
  283.                 bytesPerFrame = 1; 
  284.                 samplesPerFrame = 1;
  285.                 sampleDataOffset = (Ptr)&sndHdrPtr->sampleArea - (Ptr)sndHdrPtr;
  286.             break;
  287.  
  288.             case extSH:
  289.             {
  290.                 ExtSoundHeaderPtr extSndHdrP;
  291.  
  292.                     extSndHdrP = (ExtSoundHeaderPtr)sndHdrPtr;
  293.                     sndDescPtr->dataFormat = kRawCodecType;
  294.                     /* uncompressed offset-binary data */
  295.  
  296.                     /* we typecast a long to a short here, and it should really be fixed */
  297.                     sndDescPtr->numChannels = (short)extSndHdrP->numChannels;
  298.                     /* number of channels of sound */
  299.                     sndDescPtr->sampleSize = extSndHdrP->sampleSize;
  300.                     /* number of bits per sample */
  301.                     sndDescPtr->sampleRate = extSndHdrP->sampleRate; 
  302.                     /* sample rate */
  303.                     numFrames = extSndHdrP->numFrames;
  304.                     *numSamples = numFrames;
  305.                     bytesPerFrame = extSndHdrP->numChannels * ( extSndHdrP->sampleSize / 8);
  306.                     samplesPerFrame = 1;
  307.                     *sndDataSize = numFrames * bytesPerFrame;
  308.                     sampleDataOffset = (Ptr)(&extSndHdrP->sampleArea) - (Ptr)extSndHdrP;
  309.             }
  310.             break;
  311.  
  312.             case cmpSH:
  313.             {
  314.                 CmpSoundHeaderPtr cmpSndHdrP;
  315.  
  316.                 cmpSndHdrP = (CmpSoundHeaderPtr)sndHdrPtr;
  317.                 /* we typecast a long to a short here, and it should really be fixed */
  318.  
  319.                 sndDescPtr->numChannels = (short)cmpSndHdrP->numChannels;
  320.                 /* number of channels of sound */
  321.                 sndDescPtr->sampleSize = cmpSndHdrP->sampleSize;
  322.                 /* number of bits per sample before compression */
  323.                 sndDescPtr->sampleRate = cmpSndHdrP->sampleRate;
  324.                 /* sample rate */
  325.                 numFrames = cmpSndHdrP->numFrames; 
  326.                 sampleDataOffset =(Ptr)(&cmpSndHdrP->sampleArea) - (Ptr)cmpSndHdrP;
  327.                 
  328.                 switch (cmpSndHdrP->compressionID) 
  329.                 {
  330.                     case threeToOne:
  331.                         sndDescPtr->dataFormat = kMACE3Compression;
  332.                         /* compressed 3:1 data */
  333.                         samplesPerFrame = kMACEBeginningNumberOfBytes; 
  334.                         *numSamples = numFrames * samplesPerFrame;
  335.                         
  336.                         switch (cmpSndHdrP->numChannels) 
  337.                         {
  338.                             case 1:
  339.                                 bytesPerFrame = cmpSndHdrP->numChannels 
  340.                                                     * kMACE31MonoPacketSize;
  341.                             break;
  342.                             
  343.                             case 2:
  344.                                 bytesPerFrame = cmpSndHdrP->numChannels 
  345.                                                     * kMACE31StereoPacketSize;
  346.                             break;
  347.                             
  348.                             default: 
  349.                                 CheckError(-1, "Corrupt sound data" );
  350.                             break;
  351.                         }
  352.                         
  353.                     *sndDataSize = numFrames * bytesPerFrame;
  354.                     break;
  355.                     
  356.                     case sixToOne:
  357.                         sndDescPtr->dataFormat = kMACE6Compression; 
  358.                         /* compressed 6:1 data */
  359.                         samplesPerFrame = kMACEBeginningNumberOfBytes; 
  360.                         *numSamples = numFrames * samplesPerFrame;
  361.                         
  362.                         switch (cmpSndHdrP->numChannels) 
  363.                         {
  364.                             case 1:
  365.                                 bytesPerFrame = cmpSndHdrP->numChannels 
  366.                                                     * kMACE61MonoPacketSize; 
  367.                             break;
  368.                             
  369.                             case 2:
  370.                                 bytesPerFrame = cmpSndHdrP->numChannels 
  371.                                                     * kMACE61StereoPacketSize; 
  372.                             break;
  373.                             
  374.                             default:
  375.                                 CheckError(-1, "Corrupt sound data" );
  376.                             break;
  377.                         }
  378.                         
  379.                         *sndDataSize = (*numSamples) * bytesPerFrame;
  380.                     break;
  381.                     
  382.                     default:
  383.                         CheckError(-1, "Corrupt sound data" );
  384.                     break;
  385.                     }
  386.                     
  387.                 } /* switch cmpSndHdrP->compressionID:*/
  388.                 
  389.                 break;  /* of cmpSH: */
  390.  
  391.                 default:
  392.                     CheckError(-1, "Corrupt sound data" );
  393.                 break;
  394.  
  395.         } /* switch sndHdrPtr->encode */
  396.         
  397.     *sndDataOffset = sndHdrOffset + sampleDataOffset; 
  398. } 
  399.  
  400.  
  401. /************************************************************
  402. *                                                           *
  403. *    QTSound_GetSndHdrOffset()                              *
  404. *                                                           *
  405. *    Returns an pointer to the first sound command in the   *
  406. *    sound resource                                         *
  407. *                                                           *
  408. *************************************************************/
  409.  
  410. static long QTSound_GetSndHdrOffset (Handle sndHandle)
  411. {
  412.     short howManyCmds;
  413.     long sndOffset = 0;
  414.     Ptr sndPtr;
  415.  
  416.         if (sndHandle == nil)
  417.         {
  418.             return 0;
  419.         }
  420.         sndPtr = *sndHandle;
  421.         if (sndPtr == nil)
  422.         {
  423.             return 0;
  424.         }
  425.  
  426.         if ((*(SndListPtr)sndPtr).format == firstSoundFormat) 
  427.         {
  428.             short synths = ((SndListPtr)sndPtr)->numModifiers;
  429.             sndPtr += ( sizeof(Snd1Header) + (sizeof(ModRef) * synths) );
  430.         }
  431.         else 
  432.         {
  433.             sndPtr += sizeof(Snd2Header);
  434.         }
  435.  
  436.         howManyCmds = *(short *)sndPtr;
  437.  
  438.         sndPtr += sizeof(howManyCmds);
  439.         /* 
  440.         sndPtr is now at the first sound command--cruise all
  441.         commands and find the first soundCmd or bufferCmd
  442.         */
  443.         while (howManyCmds > 0) 
  444.         {
  445.             switch (((SndCmdPtr)sndPtr)->cmd) 
  446.             {
  447.                 case (soundCmd + dataOffsetFlag):
  448.                 case (bufferCmd + dataOffsetFlag):
  449.                     sndOffset = ((SndCmdPtr)sndPtr)->param2;
  450.                     howManyCmds = 0;    /* done, get out of loop */
  451.                 break;
  452.                 
  453.                 default:/* catch any other type of commands */
  454.                     sndPtr += sizeof(SndCommand);
  455.                     howManyCmds--;
  456.                 break;
  457.             }
  458.         }/* done with all commands */
  459.  
  460.         return sndOffset;
  461. }/* of GetSndHdrOffset */ 
  462.